Метод ICoreCollection::InsertItem

Добавляет элемент в указанную позицию коллекции.

IDL

[id(101001)]
HRESULT InsertItem(
    [in] long Index, 
    [in] ICoreCollectionItem* Item
);

Параметры

Параметры	Описание
Index	Индекс элемента
Item	Экземпляр элемента коллекции

Описание

Перед добавлением элемента проверяет существование в коллекции элемента со значением ключевого поля (ICoreCollectionItem::KeyValue), равным значению ключевого поля элемента, добавляемого с помощью метода ICoreCollection::CheckItemKey.

Если в коллекции уже содержится элемент с таким значением ключевого поля, то генерируется исключение, и добавление в коллекцию не выполняется. Иначе добавляет элемент в указанную позицию коллекции.

После добавления элемента его свойству ICoreCollectionItem::ParentCollection устанавливается ссылка на объект коллекции, в которую он был добавлен.

Примечания

№	Описание
1.	Сравнение значений ключевых полей элементов является регистронезависимым.

Требования

№	Описание
1.	Индекс, указанный в параметре, находится в интервале от 0 до ICoreCollection::Count.